.. _cmmSxOptSetIniSpeed:

cmmSxOptSetIniSpeed
======================
----------------------

SYNOPSYS
```````````

.. code-block:: none

    VT_I4 cmmSxOptSetIniSpeed(
        [in] VT_I4 Axis, [in] VT_R8 IniSpeed
        )


DESCRIPTION
`````````````

- 모션의 초기 속도를 설정하거나 설정값을 얻어옵니다.

PARAMETER
```````````

- Axis: 축번호. 축번호는 상수값으로 [cmX1] 부터 0 번째 축을 기준 축으로 임의의 축을 설정할 수 있습니다.

\

- IniSpeed : cmmSxOptSetIniSpeed 함수의 인자이며, 초기 속도를 설정하기 위한 매개변수입니다.


RETURN VALUE
`````````````

+--------------+-----------+
| Value        | Meaning   |
+==============+===========+
| 음수         | 수행 실패 |
+--------------+-----------+
| cmERR_NONE   | 수행 성공 |
+--------------+-----------+


EXAMPLE
`````````

.. code-block:: c++
 :linenos:
 :emphasize-lines: 5

 C/C++

 #include “Cmmsdk.h”
 #include “CmmsdkDef.h”

 void OnSetInitSpeed ()
 {
    long nAxisNo = 1;       // 초기 속도를 설정할 대상 축을 선택합니다.
    double fIniSpeed;       // 초기 속도 정보.

    /* 해당 축의 초기 속도 값을 확인 후, 초기 속도를 ‘100’으로 설정합니다.
    if (cmmSxOptGetIniSpeed ( nAxisNo, &fIniSpeed ) == cmERR_NONE )
    {
        if ( fIniSpeed != 100 )
        {       
            // 해당 축의 초기 속도 값을 ‘100’으로 설정합니다.
            cmmSxOptSetIniSpeed ( nAxisNo, 100 );
        }
    }
 }


.. code-block:: none
 :linenos:

 Visual Basic

 Private Sub OnSetInitSpeed ()

    Dim nAxisNo As Long ‘ 초기 속도를 설정할 대상 축을 선택합니다.
    Dim fIniSpeed As Long ‘ 초기 속도 정보.

    nAxisNo = 1

    ‘ 해당 축의 초기 속도 값을 확인 후, 초기 속도를 ‘100’으로 설정합니다.
    If cmmSxOptGetIniSpeed ( nAxisNo, fIniSpeed ) = cmERR_NONE Then

        If fIniSpeed <> 100 Then
            ‘ 해당 축의 초기 속도 값을 ‘100’으로 설정합니다.
            Call cmmSxOptSetIniSpeed ( nAxisNo, 100 )
        End If
    End If

 End Sub


.. code-block:: none
 :linenos:

 Delphi

 procedure OnSetInitSpeed ();
 var
    nAxisNo : LongInt; // 초기 속도를 설정할 대상 축을 선택합니다.
    fIniSpeed : Double; // 초기 속도 정보.

 begin
    // 해당 축의 초기 속도 값을 확인 후, 초기 속도를 ‘100’으로 설정합니다.
    if cmmSxOptGetIniSpeed (cmX1, @fIniSpeed ) = cmERR_NONE then
    begin
        if fIniSpeed <> 100 then
        begin
            // 해당 축의 초기 속도 값을 ‘100’으로 설정합니다.
            cmmSxOptSetIniSpeed ( nAxisNo, 100 );
        end;
    end;

 end;



.. seealso:: :ref:`cmmSxOptGetInispeed`